This folder contains the principal developer documentation for QuickDraw 3D. The subfolders contain these documents:
3D Graphics Programming With QuickDraw 3D
3D Metafile Reference
All books are in Adobe Acrobat™ format. (See installation and usage instructions below.) In addition, the book "3D Graphics Programming With QuickDraw 3D" is provided in a hypertext format for viewing with QuickView™, in the same manner as Macintosh Programmer's Toolbox Assistant. (See QuickView instructions below.)
INSTALLING ACROBAT READER
To view the documents in this folder, you must first install Adobe Acrobat Reader onto your system. Follow these steps:
1. Find the Acrobat Reader Installer on this CD. You can drag it to your hard disk before
installing, if you wish.
2. Launch the Installer, read the license agreement, and click Continue.
3. The Installer creates a folder named "Adobe Acrobat 2.0" on your hard disk, and
installs version 2.0.1 of the Reader, a Help file, a ReadMe file, some fonts,
and a version of ATM (if necessary).
4. When installation completes, click Restart to restart your machine.
(If you have QuickDraw GX installed on your machine, see the additional installation instructions in the "ReadMe-Reader 2.0.1" file in your Adobe Acrobat 2.0 folder.)
You can now read any of the Acrobat documents on this CD. Acrobat documents are recognizable because their icons display the letters "PDF". Also, their filenames commonly have a .pdf suffix.
USING ACROBAT READER
The Help folder in your Adobe Acrobat 2.0 folder contains an Acrobat document ("Help-Reader.pdf") that describes how to use the Reader. But here are some of the basics, plus some notes specific to the documents in this folder:
• Launch any Acrobat file by double-clicking on it. By default it opens at 100%,
but you can change the magnification in various ways, and you can also display
thumbnail views to accompany the page you are viewing. You can use the
Preferences command in the File menu to change the default magnification
(as well as other settings) that a document uses when first opened .
NOTE 1: The documents in this folder do not display well at 125%; some
characters are distorted. Viewing at another magnification, such as100% or
120%, is preferable. (You can even specify a custom size, such as 137%).
NOTE 2: Screen-shot graphics may not display well at 100% (although they
will print correctly). Viewing at a higher magnification (such as 200%) should
solve the problem.
• You can navigate through the document page-by-page or in larger jumps, by clicking
on several kinds of arrow buttons in the tool bar at the top of the screen, by using
commands in the View menu, or by using the window scroll bars.
• Some documents have bookmarks that aid navigation. The bookmark list functions
as a hypertext table of contents. To display or hide the bookmark list, use the
leftmost two buttons in the toolbar across the top of the screen.
• Some documents have hypertext jumps within their tables of contents, indexes,
and in cross-references throughout their body text. The presence of a hypertext
jump is indicated by the cursor changing shape to a hand with extended
index finger. Click once on the hypertext element to jump to its destination.
• You can select either text or graphics to copy to the Clipboard. (You cannot use
Acrobat Reader to cut from a document or paste into it.)
• Acrobat Reader supports a simple Find command, accessed from the Tools menu.
INSTALLING QUICKVIEW
The book "3D Graphics Programming With QuickDraw 3D" is also available as a QuickView database, which gives you rapid access to up-to-date information about the QuickDraw 3D API. It provides a complete reference to all QuickDraw 3D functions, types, and constants. It includes extensive hypertext links for rapid, easy navigation and provides useful features such as copy text, fast full-text search, user annotations, and resizable windows.
To install QuickView, copy the QuickDraw 3D reference (qv) folder to your hard drive. The folder contains the QuickView application, a Help file, and the QuickDraw 3D database. For the current version of QuickView, the QuickView application and any of its databases must reside in the same folder.
USING QUICKVIEW
If you have questions on how to use QuickView and its databases, you can consult the QuickView Help file, accessed through the Help menu when QuickView is active. For this release, only the Macintosh Programmer's Toolbox Assistant Help file is available. That Help file explains correctly how to use QuickView.
Macintosh Programmer's Toolbox Assistant Users
Please read the "QuickView ReadMe" file for instructions on adding the QuickDraw 3D database to Toolbox Assitant.
Feedback
We value your feedback on this and other Macintosh developer documentation. You can contact us by e-mail at
